SetRowColumn(Int32,Int32,Byte[],Int32,Int32) Method

public int SetRowColumn( 
   int row,
   int column,
   byte[] buffer,
   int bufferIndex,
   int bufferCount
)

'Declaration
 
Public Overloads Function SetRowColumn( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal buffer() As Byte, _
   ByVal bufferIndex As Integer, _
   ByVal bufferCount As Integer _
) As Integer

'Usage
 
Dim instance As RasterImage
Dim row As Integer
Dim column As Integer
Dim buffer() As Byte
Dim bufferIndex As Integer
Dim bufferCount As Integer
Dim value As Integer
 
value = instance.SetRowColumn(row, column, buffer, bufferIndex, bufferCount)

public int SetRowColumn( 
   int row,
   int column,
   byte[] buffer,
   int bufferIndex,
   int bufferCount
)

-(ssize_t)setRowColumn:(int)row 
                column:(int)column 
                buffer:(const unsigned char*)buffer 
           bufferCount:(size_t)bufferCount 
                 error:(NSError**)outError;
            

public int setRowColumn(
  int row, 
  int column, 
  byte[] buffer, 
  int bufferIndex, 
  long bufferCount
)
            

 function Leadtools.RasterImage.SetRowColumn(Int32,Int32,Byte[],Int32,Int32)( 
   row ,
   column ,
   buffer ,
   bufferIndex ,
   bufferCount 
)

public:
int SetRowColumn( 
   int row,
   int column,
   array<byte>^ buffer,
   int bufferIndex,
   int bufferCount
) 

Parameters

row

The number of the row to update. The first row is 0, and the last row is 1 less than the image height.

column

The column offset within the row to update. The first column offset is 0, and the last column offset is 1 less than the image width.

buffer

Buffer containing the image data. The buffer should contain uncompressed data regardless of whether the image is compressed or not.

bufferIndex

0-based index into the output buffer. This is the start location of input data.

bufferCount

The number of bytes to update. Consider the bits per pixel, and avoid specifying a number that goes past the end of the row.

For a 1-bit image, each byte represents 8 pixels. For a 4-bit image, each byte represents 2 pixels. For an 8-bit image, each byte represents 1 pixel. For a 16-bit image, every 2 bytes represents one pixel. For 24-bit images, every three bytes represents one pixel. For a 32-bit image, every four bytes represents one pixel. For a 48-bit image, every six bytes represents one pixel. For a 64-bit image, every eight bytes represents one pixel.

Return Value

By using this low-level method to update any part of a row, you can write a procedure that updates a single pixel or a rectangular area within the image.

This method accepts an offset parameter (column) in pixels and a length (bufferCount) in bytes. Therefore, you must consider the bits per pixel of the image when specifying these parameters. The following table describes the rules:

The image memory must be locked when you use this method. Normally, you can call Access to lock the memory before starting an operation that uses this method. Then call Release when the operation is finished.

Color order is determined by the Order property of the RasterImage object. This value can be RasterByteOrder.Rgb, RasterByteOrder.Bgr, or RasterByteOrder.Romm.

RasterByteOrder.Gray is only valid for 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is only available in the Document/Medical Imaging editions.

For more information, refer to Introduction to Image Processing With LEADTOOLS.

Target Platforms

Reference

RasterImage Class
RasterImage Members
Overload List